home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 2 / AACD 2.iso / AACD / Magazine / GraphicsCards / StormMesa / README.BEOS < prev    next >
Text File  |  1998-12-15  |  5KB  |  165 lines
  1. ========================================================
  2. MESA 2.6 BEOS PORT RELEASE 2
  3. ========================================================
  4.  
  5. BeOS notes
  6. --------------------------------------------------------
  7.  
  8.     The BeOS driver is implemented through Mesa's 
  9.     Off-Screen rendering interface. This is the best way
  10.     to integrate it into the C++ framework of the BeOS.
  11.     As of this second port, the mesa accelerated 3Dfx driver
  12.     is also supported.
  13.     The TK and AUX are partially supported but somewhat unstable.
  14.     
  15.  
  16. Installing the library
  17. --------------------------------------------------------
  18.  
  19.     You'll have to build the library, and copy the files from
  20.     Mesa2.6/lib/ into your /boot/home/config/lib/ directory.
  21.  
  22.  
  23. Rebuilding the library
  24. --------------------------------------------------------
  25.  
  26.     Type 'make beos-ppc', 'make beos-x86', or 'make beos-glide' (for the accelerated version)
  27.     in the Mesa2.6/ directory to compile the library and the demos.
  28.     You will naturally need the unlimited linker.
  29.  
  30.     For the x86 version you will have to play with the OSMesaCreateContext() parameters
  31.     as the OSMESA_BGRA used in the ppc version makes the colors screwy in the x86
  32.     version (damn little endian CPU....), see line 897 of src-tk/tkbeos.cpp and 
  33.     include/GL/osmesa.h for more info.
  34.  
  35.     The glide version expects the lib3DfxGlide2X.so library to be in your
  36.     /boot/home/config/lib directory, and the glide/ directory (containing
  37.     at least the include/ directory) to be in the same directory as the
  38.     Mesa-2.6 directory. These files are in the glide.zip package, see the
  39.     changes section.
  40.  
  41.  
  42. BeOS demos
  43. --------------------------------------------------------
  44.  
  45.     I have converted some of the supplied demo into
  46.     BeOS specific code to show how to integrate
  47.     Mesa into your own projects. Look in the BeOS/
  48.     directory to test them.
  49.     NOTE that these demos directly use the OSMesa driver and
  50.     don't work with the glide version of the library. Looking
  51.     at src-tk/tkbeos.cpp it should be trivial to convert them
  52.     to an accelerated version.
  53.     For animation demos try the 'wave' and the 'logo'
  54.     demo:
  55.  
  56.     wave demo keys:
  57.  
  58.     c        Toggle contouring mode.
  59.     s        Toggle flat/smooth shade mode.
  60.     l        Toggle lighting mode.
  61.     d        Toggle depth checking mode.
  62.     a        Toggle spin mode.
  63.     
  64.     logo demo keys:
  65.     
  66.     LEFT    Rotate.
  67.     RIGHT    Rotate
  68.     UP        Move clipping plane.
  69.     DOWN    Move clipping plane.
  70.     Z    Translate.
  71.     z    Translate.
  72.     1    Use GL_POINT polygon mode.
  73.     2    Use GL_LINE polygon mode.
  74.     3    Use GL_FILL polygon mode.
  75.     p    Toggle polygon fill modes.
  76.     4    Use GL_NICEST for GL_POLYGON_SMOOTH_HINT.
  77.     5    Use anti-aliased polygon mode.
  78.     6    Use aliased polygon mode.
  79.     8    Toggle dither mode.
  80.     9    Toggle stipple polygon mode.
  81.     0    Toggle flat/smooth shading mode.
  82.     q    Disable cull mode.
  83.     w    Use front face cull mode.
  84.     e    Use back face cull mode.
  85.     r    Use clockwise front face mode.
  86.     t     Use counter-clockwise front face mode.
  87.     y    Use MSB first stipple pattern.
  88.     u    Use LSB first stipple pattern.
  89.     a    Use brick texture map.
  90.     s    Use checker texture map.
  91.     d    Disable texture map.
  92.     f    Use decal texture environment mode.
  93.     g    Use modulate texture environment mode.
  94.  
  95.  
  96.     
  97. How to compile the other demos in samples/ and demos/
  98. --------------------------------------------------------
  99.  
  100.     Just type 
  101.         
  102.         'mwcc demo.c -I../include ../lib/libMesaGL.so'
  103.  
  104.     or something similar. I especially like the
  105.     isosurf.c in demos/ ...
  106.  
  107. NOTE: R3 has broken the demos, due to some of the code in BeBuild.h. Either make sure that file isn't included or comment out the stuff in the GL section if you want to build the demos.
  108.  
  109. Changes
  110. -------
  111.  
  112.     In the second release I (Duncan Wilcox) have reworked
  113.     the Makefiles a bit, and added out of the box support for
  114.     the 3Dfx drivers by David Bucciarelli. To use or build the
  115.     3Dfx versions, you'll need the Glide driver ported to BeOS
  116.     by Be, Inc. The file is called glide.zip, and currently is
  117.     at ftp://ftp.be.com/pub/samples/preview/graphics/glide.zip
  118.  
  119.     I didn't have time to work on a BeOS version of GLUT, but
  120.     the version that Jake Hamby (jehamby@be.com) ported is probably
  121.     the best start, if you want to try and adapt it to Mesa. You
  122.     can find that at ftp://ftp.be.com/pub/beos_updates/developers/glut-3.5.zip
  123.  
  124.     While it's a bit of a hack, you'll find that src-tk/tkbeos.cpp
  125.     provides most of the ideas to use Mesa in a BeOS application both for
  126.     off screen and accelerated rendering.*
  127.  
  128.     The libraries have been split into four (libMesaGL.so, libMesaGLU.so, libMesatk.so,
  129.     and libMesaaux.so).
  130.  
  131.     Tinic Uro did most of the work with the first BeOS port, at DR8.2 time.
  132.  
  133.  
  134.     *The tkbeos.cpp file has been updated slightly to fix some mouse problems.
  135.     Also the Makefiles have been updated to support x86 versions.
  136.  
  137. ToDo
  138. --------------------------------------------------------
  139.  
  140.     - implementing a BeOS context.
  141.     - Better support of the TK and AUX package.*
  142.     - Speedups
  143.     - split into four shared libraries.**
  144.     - bugfixes
  145.     - a FXhack similar to the X driver, to use glide
  146.       acceleration in a window
  147.  
  148.     *fixed, see Changes section above.
  149.     **Done.
  150.  
  151. Author
  152. --------------------------------------------------------
  153.  
  154.     Send bugreports, comments and other stuff to:
  155.  
  156.     Tinic Uro <5uro@informatik.uni-hamburg.de>
  157.  
  158.     or
  159.  
  160.     Duncan Wilcox <duncan@mclink.it>
  161.  
  162.     or 
  163.     
  164.     Ed Silva <esilva@earthlink.net>
  165.